Prevents the Memory Manager from purging the base address for an offscreen pixel image.

void NoPurgePixels (
    PixMapHandle pm
);

pm

A handle to an offscreen pixel map.

DISCUSSION

The NoPurgePixels function marks the base address for an offscreen pixel image as unpurgeable.

To get a handle to an offscreen pixel map, use the GetGWorldPixMap function. Then supply this handle for the pm parameter of NoPurgePixels.

SPECIAL CONSIDERATIONS

The NoPurgePixels function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)